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Turbo-Plus VI.41 8-bit Installation Guide 


INTRODUCTION 

This Installation Guide describes the procedure for 
generating a configuration of Turbo-Plus to meet a given system’s 
specifications. 

For information on using the package refer to the User’s 
Guide to Turbo-Plus . That manual includes an overview of the 
package, and instructions on using each command. 


Turbo-Plus is designed with the ability to be patched to run 
on systems with different search drives. Since it needs to know 
what drive this is, it is set up as a patchable parameter. Thus, 
most of Turbo-Plus’s modules are distributed as relocatable 
(.REL) files, so that parameters may be ’plugged in’ in the 


inS tal 1 at iOn procedure using the 


TurboDOS symbolic patch facility 


described in the Configuration Guide to TurboDOS. 


Section 2 of this guide briefly describes all of the modules 
sent as part of the Turbo-Plus package, and explains where on the 
system they should be placed. 


Section 3 describes the installation procedure for 
generating a customized version of Turbo-Plus excluding the 
background batch processor, which involves some extra steps. 


Section 4 describes the installation procedure for the 
background batch processor. 
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Overview 


Turbo-Plus makes extensive use of the TurboDOS User Defined 
Function (TurboDOS call 29H) and follows the USRSUP calling 
protocol, outlined in your TurboDOS 1.41 update notes, and in 
Appendix C of this manual. Therefore, if you wish to add your own 
functions with this call, it is imperative that you also follow 
the USRSUP protocol, which has been adopted by Software 2000 as 
the standard TurboDOS method. 


Serialization 

Each copy of Turbo-Plus is serialized to be run only on a 
particular TurboDOS operating system. The serial number must 
agree with that of the operating system on which it is to be run. 
None of the modules in Turbo-Plus will run on any system with a 
serial number different that its own. 
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Turbo-Plus Installation 
Check List 

THIS CHECKLIST IS FOB PUBE 8 BIT INSTALLATIONS ONLY 


[ ] 1. Bead the Turbo-Plus Installation Guide. 

[ ] 2. Bun INSTALL.COM. 

This program will ask questions about your TurboDOS 
version, and your SYSTEM BOOT drive and SEABCH drive. 
It will then create the proper .PAB files for your 
configuration and proceed to GEN the Turbo-Plus 
modules. When GEN is complete, it will copy all of the 
appropriate files to their correct destinations on your 
system. 

[ ] 5. Bun BBINSTAL.COM !OPTIONAL! 

If you desire to use the Background Batch commands, it 
will be necessary to run this installation program. 
BBINSTAL will ask the same questions as above and in 
addition will require a particular user area 
designation where it can reside when idle and maintain 
it’s files. 

[ ] 4. COPY all help (.HLP) files from Distribution Disk(s) 

to user 0 of your search drive. 

[ ] 5. COPY TPLUSS.BEL, TPLUSM.REL, C0N96TP.BEL, CONBB.REL, 

TWXTV.REL and TWXNUL.BEL to the area of your disk where 
you generate your TurboDOS systems. 

[ ] 6. GEN all Slaves - Be sure that each OSSLAVEx.GEN 

includes C0N96TP.BEL (replacing your existing 

C0N96.REL), TPLUSS.BEL and TWXTV.REL (or TWXNUL.BEL), 
as well as USRSUP.REL, NETSVC.BEL and NETFWD.BEL (all 
supplied by Software 2000, Inc., but not generally 
included in slave generation). 

[ ] 7. GEN Background Batch slave. I OPTIONAL! 

[ ] a. In order to allow the BATCH PROCESSING slave to recover 

from console input conditions (illegal in BB), 
substitute CONBB.REL for C0N96TP.REL on the 

OSSLAVEx.GEN designated in the BBINSTAL session. 

[ ] b. Include LOGUSR - NN (where NN = user area specified in 

BBINSTAL - i.e. LOGUSR = IE for area 30) in this 
OSSLAVEx.PAB file. 

(Cont’d) 
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[ 1 8. GEN the Master (OSMASTER.SYS). 

Be sure to include TPLUSM.REL as well as USRSUP.REL, 
NETFWD.REL, NETREQ.REL and MSGFMT.REL (supplied by 
Software 2000, Inc.) in the OSMASTER.GEN file. 

[ ] 9. Reset and test your system. You should first notice 

the new Turbo-Plus LOGON program if everything is 
properly installed. 
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Turbo-Plus Modules 

Turbo-Plus will arrive on two CP/M format single-sided 
single-density diskettes. One of these disks will be a "flippy”, 
giving you a total of three disk sides. Side one contains all of 
the relocatable modules; side two contains .DO. .GEN. and .PAR 
files used to generate your Turbo-Plus installation; side three 
contains all of the .HLP files necessary for the HELP command. 

Program Modules 

Side one contains three types of files: 

1) Relocatable program files: 

Those files which constitute the main bodies of the 
Turbo-Plus utility programs. 

2) Relocatable subroutine files: 

Those files which contain subroutines called by the 
programs above. 

3) System function files: 

Files containing extensions to the normal set of 
TurboDOS operating system calls which must be genned 
into the operating system. 

Side two contains all of the supporting files used for 
generating your installed version of Turbo-Plus. This includes 
.GEN and .PAR files for your programs, auxiliary data files, two 
installation .COM files, and .DO files referenced by the install 
programs. 

Side three contains the text files (????????.HLP) for the 
HELP utility. All of these files should be moved to user 0 of the 
system search drive. 
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Relocatable and executable program files 


These 
code for 
relocatable 

DIRDUMP.REL 


GO.REL 


GONAME.REL 


HELP.REL 


LOCATE .REL 


LOG REL 


LOGOFF ,REL 


LOGON.REL 


MAIL.REL 

MASTER.REL 

PROFILE.REL 
RESET.REL 
STATUS.REL 

TWX.REL 

USER.REL 

WHO.REL 


are all of the files containing the assembled source 
the Turbo-Plus utilities. They are distributed in 
form, to allow the patching of parameters. 

Program which gives a master directory of any disk, 
sorted by user area. 

Program which moves users to a user area specified 
by a user-defined name. 

Utility which allows users to define names for user 
areas on the system. 

TurboDOS on-line help facility providing help on 
all TurboDOS and Turbo-Plus commands. Users may 
add their own help files. 

Utility to search certain or all system drives for 
given file or template. 

Utility to make entries in a date and time stamped 
log fi 1 e . 


Enhanced version of system logoff, notifying users 
of pending mail, and displaying system bulletins. 

Enhanced version of system logon, notifying users 
of pending mail, displaying system bulletins, and 
providing additional levels of security. 

TurboDOS mail facility to allow electronic mail to 
be sent among users on the system. 

Enhanced version of the TurboDOS ’MASTER’ command, 
providing better control of access to the master. 

Program to maintain USERID.SYS file. 

Program to reset a slave from another slave. 

Facility to continuously monitor activity of system 
users, printers, and buffers. 

TWX facility to allow users to send immediate 
messages to other consoles on the system. 

Allows user to change user areas. Performs the 
same function as the TurboDOS USER command of 
versions 1.3 and earlier. 

System status facility to display all current users 
on the system, processes they are running and other 
current system characteristics. 
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Relocatable subroutine files 

A number of routines are shared by various program modules. They 
include the following files: 

DBUFF.BEL GBUFF.REL LOGCHK.REL LOGDAT.REL 

MBUFF.REL MROUTE.REL PTABLE.REL TABLES.REL 

TPMOD.REL TPSCAN.REL 


System function files 

These files must be moved to the user area on the system where 
your system’s .GEN and .PAR files reside, and where your system 
generation takes place. Some of them must be genned into your 
system in order for Turbo—Plus to work. There are six such 
files, all on disk 1: 

TPLUSS.REL TPLUSM.REL 

TWXNUL.REL TWXTV.REL 

GQN96TP.REL CONBB.REL 


.GEN and .PAR files 

These files are necessary to patch the modules to work under your 
system configuration. 

All of the following programs have .GEN files, some of which are 
accompanied by .PAR files: 

DIRDUMP GO GONAME HELP 

LOCATE LOG LOGOFF LOGON 

MAIL MASTER PROFILE RESET 

STATUS TWX USER WHO 

The following files are necessary for the installation procedure: 

TPLUS.DO INSTALL.COM 
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Instal1ing Turbo-Plus 


Generating executable programs 

Before you begin your Turbo-Plus installation, make a backup 
of the distribution diskette(s). If you received Turbo—Plus on a 
single TurboDOS format disk. you may run the install procedure 
directly from that disk. If not, you must copy the first two 
disks onto any user area on the system other than user zero of 
the search drive. 


Wlil J.1 


current 1 y 


y our system 


f _ i. 

V ULU UU to 


To customize Turbo-Plus to your system configuration, 
execute the INSTALL command. This program will prompt you for 
your TurboDOS version number, system search drive and the drive 

include 
cessary .COM 
earch drive. 

distribution 
cution of the 
stages will 
f ound’. This 
e that if any 
version, they 
, trying to 


the colon after the drive letters); all of the ne 
files will be generated and moved down to the s 
Then, all of the .HLP files should be moved from the 
disk to user zero of the search drive. During exe 
INSTALL process, it is very possible that certain 
return with system error messages such as ’Pile not 
is due to the fact that the procedure must make sur 
of these programs were already present, in an older 
are deleted. Thus, if the programs were not there 
delete them will yield error messages. 


Note: If you do not have a system search drive, you must 
still give some drive parameter to be used by Turbo-Plus as the 
drive on which to maintain all of its files. 
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System Generation 

Before Turbo-Plus may be brought up, it is necessary to 
generate a new operating system. You should start with the .GEN 
and .PAR files which you are currently using for both your 
slave(s) and your master, but some additions will be necessary. 

Generating a new system master 

The following changes must be made to the .GEN file for your 
system master (usually STDMASTR.GEN or OSMASTER.GEN). Using your 
system editor, insert the following lines after the line for the 
hardware initialization, 

USRSUP 

TPLUSM 

The following three lines, containing modules which are 
supplied by Software 2000, but not generally included in the 
master configuration, should also be added after STDMASTR: 

NETFWD 

NETREQ 

MSGFMT 

If you have the ability to use the TWX and RESET commands, 
it is recommended that you use modified circuit drivers. Many 
existing circuit drivers have already been modified 
appropriately; if your dealer says that yours has not been, a 
revision will be necessary. There should be no change made to 
the master circuit driver, and the source for your slave circuit 
driver should be changed, following the instructions in Appendix 
A. 


Certain functions performed by Turbo-Plus utilities call for 
routing tables to be set up in the master. Turbo-Plus handles 
these changes automatically for single-circuit systems, but if 
you are utilizing more than one circuit in your system, (i.e. two 
or more types of slave boards) you will also need to add a Turbo- 
Plus slave table to your master .PAR file. If this is the case 
for your system, please refer to Appendix B for instructions on 
creating this table. 

Figure 3.1 shows a sample OSMASTER.GEN file prepared for 
Turbo-Plus. 
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Figure 3.1 

Sample OSMASTER.GEN file 


STDMASTR 

NETREQ 

MSGFMT 

NETFWD 

HDWNIT 

usrsup 

TPLUSM 

CONREH 

LSTPAR 

LSTETX 

LSTTAB 

SPDXXX 

BRTXXX 

RTCXXX 

DSKXXX 

DST58F 

DSKHHH 

HCDXXX 


STANDARD NETWORK MASTER CONFIGURATION 

NETWORK REQUEST PROCESSOR 

NETWORK MESSAGE FORMAT TABLE 

NETWORK MESSAGE FORWARDING 

HARDWARE INITIALIZATION 

USER FUNCTION INTERFACE 

TURBO-PLUS FUNCTION EXTENSIONS 

REMOTE MASTER CONSOLE 

DRIVER FOR HIGH SPEED PRINTER 

DRIVER FOR LETTER QUALITY PRINTER 

DRIVER FOR HIGH SPEED PRINTER EXPANDING TABS 

SERIAL & PARALLEL DRIVERS 

BAUD-RATE TABLES 

REAL-TIME CLOCK DRIVER 

FLOPPY DISK DRIVER 

FLOPPY DISK SPECIFICATION TABLES 

HARD DISK DRIVER 

MASTER CIRCUIT DRIVER 


COMPAT 

NMBSVC 

NMBXXX 

NMBMBS 

NMBUFS 

NMBRPS 

PATXXX 


OFO 

9 

9 

IB 

10 
IB 


Figure 3.2 

Sample OSMASTER.PAR file 


Compatibility flags 
Number of slaves 

of slaves (9) 
of message buffers 
buffers 

of network reply packets 


(27) 


(27) 


Number 
Number 
16 I/O 
Number 

60,62,64,66,68,6A,6C,6E,70,72,74,76,78,7A,7C,7E 

; Slave Port assignment table 

DSKAST = 00,DSKDRA,01,DSKDRA,00,DSKDRB,01,DSKDRB,02,DSKDRB,03,DSKDRB, 
04,DSKDRB,05,DSKDRB,06,DSKDRB,07,DSKDRB,08 , DSKDRB ; 09 s DSKDRB, 
OA,DSKDRB,OB,DSKDRB 

Disk assignment table: 

A,B = floppy drives 
C-N = Winchester disk 
PTRAST = 00,LSTDRA,01,LSTDRB,00,LSTDRC 

Printer assignment table: 

A = High speed with raw 
B - Letter quality with 
C = High speed w/ formatted 
Reserved memory above TPA 


MEMRES 

DSPPAT 


AUTUSR 

QUEAST 

SRHDRV 
ETXBR = 


( 1000 ) 

1 , 2 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0,0 

De-Spool 


= 80 
= 00 

= 8 
OE 


( 0 ), 00 ,( 0),00 


output 
raw output 
output 


table: 
Printer A —> 
Printer B —> 
Log master on to 
( 0 ), 00 ,( 0 ), 00 ,( 0 ) 


Queue A 
Queue B 

user 0, privileged 

00 ,( 0 ), 00 ,( 0 ), 00 ,( 0 ) 


Define eight valid queues (A-H) 

System search drive = H 

Baud rate on Printer B = 9600 
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Generating new slaves 

Next, in your slave .GEN files, add lines containing USRSTJP 
and TPLTJSS following the hardware initialization module. Also 
include NETSVC and NETFWD immediately after the line for 
STDSLAVE. Also, to optimize the performance of the TWX command, 
you need a special console driver, modified circuit drivers, and 
a separate module to handle the shift-in shift-out produced by 
TWX. 

If your standard console driver is C0N96, you may use the 
C0N96TP driver provided with Turbo-Plus. (To do so, simply 
replace the C0N96 line in your .GEN file with C0N96TP). If not, 
you should modify your driver such that before every console 
output, it performs a WAIT operation on the global semaphore: 
TWLOCK, and after each console output, it performs a SIGNAL 
operation on the same semaphore. It should also allow for a 
character to remove the TWX message from the 25th line of the 
screen, by calling the external routine TWXRST when this 
character is received. C0N96TP uses the ESC character by 
default, and if there is no message on the status line, it allows 
the escape to passed through normally. Figure 3.5 shows the 
C0N96TP driver, which may be used as a guideline. 

Furthermore, for those of you using TWX and RESET, your 
circuit driver may require modification. Consult appendix A for 
the necessary changes. 

The second module necessary for TWX handles the placing of 
TWX messages on the screen without interrupting normal console 
input /out put. If you are using a Televideo terminal, you may use 
the TWXTV module, which places all received TWX messages on the 
terminal status line. For any other terminal you may use the 
TWXNUL module, which simply prints each line at the current 
cursor position, followed by a carriage return-line feed 
sequence. A source listing of this module is provided and 
explained in Figure 3.6, in case you wish to modify it for your 
specific terminal. Modification may be done either by writing 
your own driver, or patching TWXNUL in the slave .PAR file. 

Figure 3.4 shows a sample slave .GEN file and figure 3.3 
shows the corresponding .PAR file. 

Once all of these changes are complete, you are ready to 
generate the new master and slaves using the GEN command in the 
usual way. (Refer to the TurboDOS configuration Guide.) Once all 
of these steps are done, copy the newly created .SYS files down 
to user zero of your boot disk, and Turbo-Plus will be ready to 
come up. 
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Sample 

COMPAT = OFO 
SRHDRV = 8 
PRTMOD =01 
QUEPTR = 1 
SPLDRV = 8 

Sample 


Figure 3.3 

STDSLAVE.PAE file 

; File Compatibility flags 
; System search, drive = H 
; Print mode = Spooled 
; Default Queue - A 
; Spool Drive = I 


Figure 3.4 
STDSLAVE.GEN file 


STDSLAVE 

•KTCim oTrn 

UX ij V \*f 

NETFWD 

NITXXX 

TJSRSUP 

TPLUSS 

C0N96TP 

TWXTV 

SPDXXX 

SLVRES 

SCDXXX 


STANDARD NETWORK SLAVE CONFIGURATION 

‘KTCTmT.TrNTDTT OT3BTTT /*IT3I 'D’DAmSOO 
?i v/xixx umtv i.UU 

NETWORK MESSAGE FORWARDING 

HARDWARE INITIALIZATION 

USER FUNCTION CALLING MODULE 

TURBO-PLUS FUNCTION EXTENSIONS 

TURBO-PLUS ASCII CONSOLE AT 9600 BAUD 

TWX CONSOLE MANAGER FOR TELEVIDEO 950/925/800 

SERIAL & PARALLEL DRIVERS 

SUBROUTINE FOR KEYBOARD RESET OF SLAVE 

SLAVE CIRCUIT DRIVER 


Special hardware-dependent modules, described in the paragraphs 
above, are in boldface. 
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Figure 3.5 

Sample Turbo-Plus Console Driver 

C0N96T - TURBODOS OPERATING SYSTEM NULL CONSOLE DRIVER 
COPYRIGHT (C) 1982, SOFTWARE 2000, INC. 


* 

; COPYRIGHT (C) 1982, SOFTWARE 2000, INC. 

; AUTHORS: RONALD E. RAISES 
; MICHAEL D. BUSCH 

; VERSION: 01/20/82 

; Edit History: JBG : 18-Jan-83 : TWX MX-Locks ins 

; JBG : Jun-83 : Control code loc 

; JBG : 9-Nov-83 : 1.30 Optimized o 

; JBG : 17-Jul-84 : Optimized output 

; JBG : 28-Sep-84 : Included with V. 

; JBG : 30-Nov-84 : Clear status lin 

1 

. IDENT C0N96T ; MODULE ID 

t 

.INSERT DREQUATE ; DRIVER SYMBOLIC EQUIVA 


0000” 



.LOG 

.DATA.# 

LOCATE IN DATA AREA 

OOCO” 

8E 

CONBR: : 

.BYTE 

8 EH 

CONSOLE BAUD RATE CQjT 

0001” 

OC 

FFCHR: : 

.BYTE 

AFF 

FORM FEED CHARACTER li 

0002” 


R25CHR: 

l 



0002” 

IB 


.BYTE 

1BH 

RESTORE 25TH LINE CHAU 

0003” 

00 

INITC: 

.BYTE 

o 

INITIALIZATION COMPLET 

0004” 

00 

EFLAG: 

.BYTE 

0 


0005 ” 

00 

BCOUNT: 

.BYTE 

0 


0006' 

QOQC 

SCOUNT: 

.WORD 

0 


0000’ 


.LOG 

. PROG. # 

; LOCATE 

IN PROGRAM AREA 

0000’ 

21 0003” 

CONDR%: 

: LX I 

H, INITC 

GET INITIALIZATION COM 

0003’ 

7E 


MOV 

A,M 


0004’ 

B7 


ORA 

A 

INITIALIZATION COMPLET 

0005’ 

CC 0106’ 


CZ 

CNINIT 

IF NOT, INITIALIZE COM 

0008’ 

7B 

..CDRV: 

MOV 

A, E 

GET FUNCTION NUMBER 

0009’ 

D608 


SUI 

8 

FUNCTION NUMBER=8? 

000B ’ 

CA 0123’ 


JZ 

CONSO 

IF SO, ERROR SHIFT OUT 

000E’ 

3D 


DCR 

A 

FUNCTION NUMBER=9? 

000F ’ 

CA 0123’ 


JZ 

CONS I 

IF SO, ERROR SHIFT IN 

0012’ 

3D 


DCR 

A 

FUNCTION NUMBER = 10? 

0013’ 

CA 0129’ 


JZ 

OPT 

IF SO, JUMP TO OPTIMIZ 

0016’ 

7B 


MOV 

A, E 

GET BACK IN A 

0017’ 

B7 


ORA 

A 

IF 0, GO TO CONSTAT 

0018’ 

2838 


JRZ 

CONST 

# 

001A’ 

3D 


DCR 

A 

IF 1, CONIN 

001B ’ 

2807 


JRZ 

CONIN 
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C0N96T 

- TUEB0D0S OPERATING 

SYSTEM 

NULL CONSOLE DRIVER 


COPYRIGHT 

[C) 1982, 

SOFTWARE 

2000, 

INC. 


001D’ 

3D 



DCR 

A 

IF 2, CONOUT 

OOIE’ 

CA 

00A6 ’ 


JZ 

CONOUT 

X * * * X X 

0021’ 

C3 

0000:04 


JMP 

SERIAL# 

• 

0024’ 



CONIN: 




0024’ 

3A 

0004” 


LDA 

EFLAG 

IF ESCAPE FLAG IS NOT 

0027’ 

B7 



ORA 

A 


0028’ 

CA 

002F ’ 


JZ 

. .SER 

JUST GO TO SERIAL, ELS 

002B ’ 

AF 



XRA 

A 

RESET FLAGS AND SEMAPH 

002C ’ 

CD 

0093’ 


CALL 

RELEAS 

* 

002F’ 



. .SER: 




AArtn i 

UUW 

r\ p 
UO 



T»TT n TT 

ruDn 

T» 

r> 

fi a tn.i a vyn it m ■ » i |*T> m \ 

da v hj unANNriij NunBrixi 

0030’ 

D5 



PUSH 

D 

AND FUNCTION NUMBER 

0031’ 

CD 

0000:04 


CALL 

SERIAL# 

GET THE CHARACTER 

0034’ 

F5 



PUSH 

PSW 

SAVE IT 

0035’ 

E67F 


ANI 

7FH 

STRIP PARITY 

0037’ 

47 



MOV 

B, A 

SAVE IT 

0038’ 

3A 

0002” 


LDA 

R25CHR 

COMPARE TO 25TH LINE B 

003B ’ 

B8 



CMP 

B 


003C ’ 

C2 

004E’ 


JNZ 

. .RET 

IF SO 

003F ’ 

3A 

0000:05 


LDA 

LINE25# 

CHECK FOR PRESENCE 

0042’ 

B7 



ORA 

A 


0043’ 

2809 


JRZ 

. .RET 

IF NONE, SKIP THIS 

0045’ 

CD 

0000:06 


CALL 

TWXRST# 

RESTORE THE LINE 

48’ 

FI 



POP 

PSW 

GET REGISTERS OF TH 

U)49 ’ 

D1 



POP 

D 

. BECAUSE WE NEED T 

004A’ 

Cl 



POP 

B 

. AND THE CHANNEL I 

004B ’ 

C3 

0000:04 


JMP 

SERIAL# 

GO AHEAD TO SERIAL# 

004E’ 



..RET: 



ELSE 

004E’ 

FI 



POP 

PSW 

GET CHAR BACK IN A 

004F ’ 

D1 



POP 

D 

RESTORE THE STACK 

0050’ 

Cl 



POP 

B 

ENDIF 

0051’ 

C9 



RET 


RETURN 

0052’ 



CONST: 




0052’ 

3A 

0004” 


LDA 

EFLAG 

IF ESCAPE FLAG IS NOT 

0055’ 

B7 



ORA 

A 

« 

0056’ 

CA 

0067’ 


JZ 

. .SER 

JUST GO TO SERIAL, ELS 

0059’ 

E5 



PUSH 

H 

SAVE HL 

OOSA’ 

2A 

0006” 


LHLD 

SCOUNT 

CHECK CON STAT COUNT 

005D’ 

23 



INX 

H 

BUMP IT 

005E’ 

22 

0006” 


SHLD 

SCOUNT 

SAVE NEW STAT COUNT 

0061’ 

7C 



MOV 

A, H 

IF 0, RELEASE ESCAPE F 

0062’ 

B5 



ORA 

L 

* 

0063’ 

CC 

0093’ 


CZ 

RELEAS 

* 

0066’ 

El 



POP 

H 

RESTORE HL 

0067’ 



. .SER: 




0067’ 

C5 



PUSH 

B 

SAVE CHANNEL NUMBER 

0068’ 

CD 

0000:04 


CALL 

SERIAL# 

AND GO TO SERIAL 

006B ’ 

D1 



POP 

D 

GET CHANNEL NUMBER BAC 

06C ’ 

B7 



ORA 

A 

IF NOTHING AVAILABLE, 
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C0N96T - TURBODOS OPERATING SYSTEM NULL CONSOLE DRIVER 
COPYRIGHT (C) 1982, SOFTWARE 2000, INC. 


006D’ 

C8 


RZ 



006E’ 

F8 


PUSH 

PSW 

SAVE REGISTERS FOR RET 

006F s 

C5 


PUSH 

B 


0070’ 

79 


MOV 

A, C 


0071 ’ 

367F 


AN I 

7FH 

STRIP PARITY 

0073 * 

47 


MOV 

B, A 

SAVE IT 

0074’ 

3A 0002” 


LDA 

R25CHR 

COMPARE TO 28TH LINE B 

0077’ 

B8 


CMP 

B 

. 

0078 ’ 

02 0090’ 


JNZ 

. .RST 

IF SO 

007B 5 

3A 0000:06 


LDA 

LINE25# 

CHECK FOR PRESENCE 

007E 5 

B7 


ORA 

A 


007F ’ 

2 8 OF 


JRZ 

. .RST 

IF NONE, SKIP THIS 

0081’ 

CD 0000:06 


CALL 

TWXRST# 

RESTORE THE LINE 

0084 1 

42 


MOV 

B, D 

GET CHANNEL NUMBER 

0085’ 

1E01 


MV I 

E,1 

CEALL CONIN TO FLUS 

0087’ 

CD 0000:04 


CALL 

SERIAL# 

# 

008A’ 

Cl 


POP 

B 

GET REGISTERS OFF S 

008B ’ 

FI 


POP 

PSW 


008C ’ 

AF 


XRA 

A 

FLAG NO CHARACTER A 

008D’ 

03 0092’ 


JMP 

, .RET 

ELSE 

0090 ’ 


. . RST: 




0090 * 

01 


POP 

B 

RESTORE REGISTERS N 

0091’ 

Fi 


POP 

PSW 


0092’ 


. .RET: 



END IF 

0092 ’ 

09 


RET 


RETURN 

0093’ 


RELEAS: 




0093’ 

32 0004” 


STA 

EFLAG 

# 

0096’ 

32 0005” 


STA 

BCOUNT 


0099’ 

C5 


PUSH 

B 

SAVE REGISTERS 

009A’ 

D5 


PUSH 

D 

* 

009B’ 

E5 


PUSH 

H 


009C ’ 

21 0000:07 


LXI 

H,TWLOCK# 

RELEASE CONSOLE 

009F ’ 

CD 0000:08 


CALL 

SIGNAL# 

# 

00A2 ’ 

El 


POP 

H 

RESTORE REGISTERS 

00A3 ’ 

D1 


POP 

D 

. 

00A4 ’ 

Cl 


POP 

B 

END IF 

00A5 ’ 

C9 


RET 


RETURN 

00A6 ’ 


CONOUT 




00A6 ’ 

3A 0004” 


LDA 

EFLAG 

IF WE ARE IN THE MIDDL 

00A9 ’ 

B7 


ORA 

A 

# 

OOAA’ 

280E 


JRZ 

..NSEQ 


OOAC ’ 

3A 0005” 


LDA 

BCOUNT 

GET BYTE COUNTER 

OOAF ’ 

3D 


DCR 

A 

DECREMENT IT 

OOBO’ 

32 0006” 


STA 

BCOUNT 

STORE IT 

00B3 ’ 

2024 


JRNZ 

..CONT 

IF IT’S ZERO 

00B5 ’ 

32 0004” 


STA 

EFLAG 

TURN OFF ESCAPE 

00B8 ’ 

181F 


JMPR 

..CONT 

END IF 

OOBA’ 


..NSEQ 



ELSE 

OOBA’ 

79 


MOV 

A, C 

GET BYTE IN A 
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C0N96T 

- TURBODOS OPERATING 

SYSTEM 

NULL CONSOLE DRIVER 


COPYRIGHT (C) 1982, 

SOFTWARE 

2000, 

INC. 


OORB ’ 

E67F 


AN I 

7FH 

STHIP PAHITY 

OOBD’ 

FE1B 


CPI 

1BH 

CHECK FOR ESCAPE 

OOBF 7 

2000 


JRNZ 

..NESC 

IF ESCAPE 

OOC1’ 

F6FF 


ORI 

OFFH 

SET FLAG 

00C3 ’ 

32 0004” 


STA 

EFLAG 


00C6 ’ 

3C 


I NR 

A 


00C7 ’ 

32 0006” 


STA 

SCOUNT 

AND INITIALIZE S 

OOCA’ 

32 0007” 


STA 

SCOUNT+1 


OOCD’ 


..NESC 

l 


END IF 

OOCD’ 

C5 


PUSH 

B 

SAVE REGISTERS 

OOCE’ 

D5 


PUSH 

D 


OOCF ’ 

E5 


PUSH 

H 


OODO’ 

21 0000:07 


LX I 

H,TWLOCK# 

WAIT FOR CONSOLE FRE 

00D3 ’ 

CD 0000:09 


CALL 

WAIT# 


00D6 ’ 

El 


POP 

H 

RESTORE REGISTERS 

00D7 ’ 

D1 


POP 

D 


00D8 ’ 

Cl 


POP 

B 


00D9 * 


..CONT 

l 


END IF 

00D9 ’ 

79 


MOV 

A, C 

GET BYTE IN A 

OODA’ 

E67F 


AN I 

7FH 

STRIP PARITY 

OODC ’ 

FE1B 


CPI 

1BH 

IF IT’S AN ESCAPE 

OODE’ 

2011 


JRNZ 

. . NE2 


OOEO ’ 

3E06 


MV I 

A,6 

INITIALIZE BYTE COU 

00E2 ’ 

32 0005” 


STA 

BCOUNT 


^OE5’ 

F6FF 


ORI 

OFFH 

SET FLAG 

UE7’ 

32 0004” 


STA 

EFLAG 

# 

OOEA’ 

3C 


I NR 

A 

AND INITIALIZE STAT 

OOEB ’ 

32 0006” 


STA 

SCOUNT 

* 

OOEE’ 

32 0007” 


STA 

SCOUNT+1 

* 

OOF1 ’ 


. . NE2: 



END IF 

OOF1 ’ 

CD 0000:04 


CALL 

SERIAL# 

PRINT THE BYTE 

OOF4 ’ 

3A 0004” 


LDA 

EFLAG 

CHECK ESCAPE FLAG 

00F7 ’ 

B7 


ORA 

A 

IF IT WAS NOT SET 

00F8 ’ 

CO 


RNZ 


* 

00F9 ’ 

C5 


PUSH 

B 

SAVE REGISTERS 

OOFA’ 

D5 


PUSH 

D 

* 

OOFB’ 

E5 


PUSH 

H 


OOFC ’ 

21 0000:07 


LX I 

H,TWLOCK# 

RELEASE CONSOLE 

GOFF’ 

CD 0000:08 


CALL 

SIGNAL# 


0102’ 

El 


POP 

H 

RESTORE REGISTERS 

0103’ 

D1 


POP 

D 


0104’ 

Cl 


POP 

B 

END IF 

0105’ 

C9 


RET 


RETURN 

0106’ 

35 

CNINIT 

: DCR 

M 

SET INITIALIZATION COM 

0107’ 

D5 


PUSH 

D 

SAVE FUNCTION NUMBER 

0108’ 

C5 


PUSH 

B 

SAVE CHANNEL NUMBER/CE 

0109’ 

3A 0000” 


LDA 

CONBR 

GET CONSOLE BAUD RATE 

010C’ 

4F 


MOV 

C, A 

TELEVIDEO BAUD RATE CO 

010D’ 

1E03 


MV I 

E, 3 

SET FUNCTION NUMBERS 

"10F ’ 

CD 0000:04 


CALL 

SERIAL# 

SET CHANNEL BUAD RATE 
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CON96T - TURBODOS OPERATING SYSTEM NULL CONSOLE DRIVER 
COPYRIGHT (C) 1982, SOFTWARE 2000, INC. 


0112 * 

3A 0001” 


LDA 

FFCHR 

GET FORM FEED CHARACTE 

0115’ 

B7 


ORA 

A 

FORM FEED CHARACTERS? 

0116’ 

2808 


JRZ 

..NITX 

IF SO, CONTINUE 

0118’ 

Cl 


POP 

B 

ELSE, RESTORE CHANNEL 

0119’ 

05 


PUSH 

B 

SAVE CHANNEL NUMBER 

0 X1A ’ 

4F 


MOV 

C, A 

FORM FEED CHARACTER TO 

011B ’ 

1EG2 


MV I 

E, 2 

SET FUNCTION NUMBER=2 

01 ID’ 

CD COCO:04 


CALL 

SERIAL# 

OUTPUT FORM FEED 

012U 3 

Cl 

..NITX: 

POP 

B 

RESTORE CHANNEL NUMBEB 

0121 f 

Li 


POP 

D 

RESTORE FUNCTION NUMBE 

0122’ 

CO 


RET 


DONE 

0123’ 


CONSO: 




0123 ’ 

CD 0000:0A 

CONSI: 

CALL 

DMS# 

POSITION TO NEXT LINE 

0126 s 

0D8A 


.ASCIS 

[ACR] [ALF] 


0128’ 

09 


RET 

. 

DONE 

0129 s 


OPT: 




0129’ 

3A 0000:07 


LDA 

TWLOCK# 

LOOK AT TWX LOCK 

012C * 

B7 


ORA 

A 

IF IN USE, RETURN U 

012D ’ 

C6 


RZ 



012E’ 

3A 0004” 


LDA 

EFLAG 

ELSE, IF IN MIDDLE OF 

0131’ 

B7 


ORA 

A 


0132’ 

2802 


JRZ 

..NSEQ 


0134’ 

AF 


XRA 

A 

RETURN UNSUCCESS# 

0135’ 

C9 


RET 



0138 s 


..NSEQ: 



ELSE IF THE CHARACTER 

0136’ 

79 


MOV 

A, C 


0137 s 

E67F 


AN I 

7FH 


0139 * 

D6 3 B 


SUI 

AESC 

RETURN UNSUCCESSFUL 

013B ’ 

08 


RZ 



0131 1 

03 0000:04 


JMP 

SERIAL# 

ELSE, JUST DO THE OUTP 


’end 
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Figure 3.6 

TWX Null Console Manager 
iXNUL - Turbo-Plus TWXNUL driver 


Shift-In/Shift-Out controls for null console 

AUTHOR: Jim Gabriel 

Microserve, Inc. 

Edit History: JBG : 24-Aug-83 : Revised for Turb 
JBG : 24-Jul-84 : Revised for Turb 
JBG : 28-Sep-84 : Equates changed 
JBG : 30-Nov-84 : Clear status lin 

I DENT TWXNUL 


INSERT DREQUATE 
INSERT TEQUATE 


0000” 



.LOG 

.DATA.# 



0000” 


LINE25: 

: 




0000” 

00 


.BYTE 

0 



0001” 


SICODE: 

l 




0001” 

0D0A00000000 


.BYTE 

ACR,ALF,0,0,0,0,0,0,0,0 


000B” 


SOCODE: 

• 




l^OOB” 

0D0A00000000 


.BYTE 

ACR,ALF,0,0,0,0,0,0,0,0 


Loi5” 


RSTCOD: 

l 




0015” 

000000000000 


.BYTE 

0,0,0,0,0,0,0,0,0,0 


0000’ 


s 

.LOC 

.PROG.# 



0000’ 


TWXSI: : 





0000’ 

F5 


PUSH 

PSW ; 

SAVE REGISTERS 


0001’ 

C5 


PUSH 

B 

. 


0002’ 

D5 


PUSH 

D 



0003’ 

E5 


PUSH 

H 

. 


0004’ 

21 0001” 


LX I 

H,SICODE 

SET HL FOR SHIFT 

IN 

0007’ 

1819 


JMPR 

SCONT 

• 


0009’ 


TWXSO: : 





0009’ 

F5 


PUSH 

PSW 

SAVE REGISTERS 


000A’ 

C5 


PUSH 

B 

• 


000B ’ 

D5 


PUSH 

D 



000C’ 

E5 


PUSH 

H 

♦ 


000D’ 

F6FF 


ORI 

OFFH 

SIGNAL THAT A MESSAGE 

000F’ 

32 0000” 


STA 

LINE25 

. 


0012’ 

21 000B” 


LX I 

H,SOCODE 

SET HL FOR SHIFT 

OUT 

0015’ 

180B 


JMPR 

SCONT 

• 


0017’ 


TWXRST: 

. 




0017’ 

F5 


PUSH 

PSW 

; SAVE REGISTERS 


0018’ 

C5 


PUSH 

B 

> * 


^019 ’ 

D5 


PUSH 

D 




3-11 







Turbo-Plus VI.41 8-bit Installation Guide 


TWXNUL 

- Turbo-Plus 

TWXNUL driver 



Microserve, Inc. 





001A’ 

E5 


PUSH 

H 


001B’ 

AF 


XRA 

A 

SIGNAL THAT NO MESSAGE 

001 O’ 

32 0000” 


STA 

LINE25 

* 

001F" 

21 0015” 


LX I 

H.RSTCOD 

SET HL FOR SHIFT OUT 

0022’ 


SCONT: 




0022’ 

3A "K>00:0* 


LDA 

CONAST# 

GET CONSOLE CHANNEL IN 

0025’ 

57 


MOV 

D, A 

. 

0020’ 


CLOOP: 



FOR EACH BYTE DO 

0028’ 

7E 


MOV 

A, M 

GET BYTE IN E 

0027 ’ 

B7 


ORA 

A 


0028 5 

280E 


JRZ 

SRET 


002A’ 

5F 


MOV 

E, A 


002B * 


CMOUTO: 

: 


. 

002B ’ 

0E24 


MV I 

C, 24H 

SET PARM FOR CONOUT 

002D’ 

D5 


PUSH 

D 

SAVE CHANNEL NUMBEE 

002E’ 

E5 


PUSH 

H 

SAVE POINTER 

002F’ 

AF 


XRA 

A 

. 

0030 ’ 

CD 0000:08 


CALL 

XTNTRY# 

SEND TO COM CHANNEL 

0033’ 

El 


POP 

H 

RESTORE POINTER 

0034’ 

D1 


POP 

D 

RESTORE CH NO. 

0035’ 

23 


I NX 

H 

INCREASE POINTER 

0036’ 

18 EE 


JMPE 

CLOOP 

END DO 

0038’ 

El 

SRET: 

POP 

H 

RESTORE REGISTERS 

0039’ 

D1 


POP 

D 


003A’ 

Cl 


POP 

B 

. 

003B 5 

FI 


POP 

PSW 


0C3C ’ 

C9 


RET 


RETURN 


!end 
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To modify this driver you may either write your own, or use 
the symbolic patch facility. The primary reason to write your 
own would be to perform operations other than a simple console 
output of a string of bytes, such as code to also keep track of 
the cursor position before the message. 

If you wish to do this, the module must meet the following 
specifications: It must have the global entry points TWX8I, 

which will be called before every TWX line, to position the 
cursor as desired; TWXSO, which will be called after every TWX 
line, to restore the cursor; and TWXEST, which will be called to 
remove the TWX message from the 25th line. All console output 
must be done via calls to the comm channel, which is defined in 
register D upon entry to the routine. 

If your only modifications involve changing the string of 
bytes to be sent out before and after each message, it will 
probably be more convenient to use the TurboDOS symbolic patch 
facility. The routine allows for up to ten bytes to be patched 
at locations SICODE, SOCODE, and ESTCOD for the sequences to be 
sent out before the message, after the message, and to remove the 
message respectively. For example, if you wish to send out five 
bells and a clear screen at the beginning, five bells and a 
carriage return-line feed sequence at the end, and an ESCAPE, 
control-G sequence to remove the message, your .PAH file for the 
slave could be patched as follows, using TWXNUL: 

SICODE * 07,07,07,07,07,00 
SOCODE * 07,07,07,07,07,OD,OA 
ESTCOD ■ IB,07 

However, if you are using one type of terminal frequently, 
it may be easiest to write a special driver for it, even if it 
only involves changing the bytes, so that you need not change 
every .PAE file which you use. An example of such a driver is 
TWXTV, shown in Figure 3.7, written for the Televideo 800, 925, 
and 950 terminals. This driver is designed to take advantage of 
the status line of the terminal. All TWX messages will appear on 
this line, leaving the user’s screen intact. 
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Figure 3.7 

TWX Televideo Console Manager 

TWXTV - Turbo-Plus TWXTV driver 
Microserve, Inc. 


Shi £t-In/Shift-Out controls for Televideo 925/95 


AUTHOR: Jim Gabriel 

Microserve, Inc. 


Edit History: JBG 
JBG 
JBG 
JBG 


24-Aug-83 : Bevised for Turb 
24-Jul-84 : Revised for Turb 
28-Sep-84 : Equates changed 
30-Nov-84 : Clear status lin 


. I DENT TWXTV 

! INSERT DREQUATE 
.INSERT TEQUATE 


0000” 



.LOG 

.DATA.# 


0000” 


LINE25: 




0000” 

Oij 


.BYTE 

0 


0001” 


SICODE: 




0001” 

071B671B661B 


.BYTE 

ABEL,AESC,67H,AESC,66H,AESC,47H , 3CH,0 £ 

000B” 


SOCODE: 




000B” 

0D0000000000 


.BYTE 

ACR,0,0,0,0,0,0,0,0,0 

0015” 


RSTCOD: 




0015” 

1B6800000000 


. BYTE 

AESC,68H,0,0,0,0 

o 

o 

o 

o 

0000’ 


t 

.LOC 

.PROG.# 


0000’ 


TWXSI: : 




0000’ 

F5 


PUSH 

PSW 

SAVE REGISTERS 

0001’ 

C5 


PUSH 

B 

* 

0002’ 

D5 


PUSH 

D 


0003’ 

E5 


PUSH 

H 


0004’ 

21 0001” 


LX I 

H , SICODE 

SET HL FOR SHIFT IN 

0007’ 

1819 


JMPR 

SCONT 

• 

0009’ 


TWXSO : : 




0009’ 

F5 


PUSH 

PSW 

SAVE REGISTERS 

000A’ 

C5 


PUSH 

B 

• 

000B ’ 

D5 


PUSH 

D 


000C’ 

E5 


PUSH 

H 


000D’ 

F6FF 


ORI 

OFFH 

SIGNAL THAT A MESSAGE 

000F ’ 

32 0000” 


STA 

LINE25 

. 

0012’ 

21 000B” 


LX I 

H,SOCODE 

SET HL FOR SHIFT OUT 

0015’ 

180B 


JMPR 

SCONT 

• 

0017’ 


TWXRST: 

. 



0017’ 

F5 


PUSH 

PSW 

SAVE REGISTERS 
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TWXTV - Turbo-Plus TWXTV driver 
Microserve, Inc. 

t _ _ _ 


l Jl8 ’ 

C5 


PUSH 

B 


0019’ 

D5 


PUSH 

D 


001A’ 

E5 


PUSH 

H 


001B ’ 

AF 


XBA 

A 

SIGNAL THAT NO MESSAGE 

001C * 

32 0000” 


STA 

LINE25 


001P’ 

21 0015” 


LX I 

H,RSTCOD 

SET HL FOR SHIFT OUT 

0022’ 


SC0NT: 




0022’ 

3A 0000:04 


LDA 

CONAST# 

GET CONSOLE CHANNEL IN 

0025’ 

57 


MOV 

D, A 


0026’ 


CL00P: 



FOR EACH BYTE DO 

0026 ’ 

7E 


MOV 

A,M 

GET BYTE IN E 

0027’ 

B7 


ORA 

A 


AAO O 5 

A A Am 


tt-> nr 

OT^mm 



AOUCJ 


UXIU 

Q XL AH X 

• 

002A’ 

5F 


MOV 

E, A 

• 

002B ’ 


CM0IIT0: 

: 


* 

002B ’ 

0E24 


MV I 

C, 24H 

SET PARM FOR CONOUT 

002D’ 

D5 


PUSH 

D 

SAVE CHANNEL NUMBEB 

002E’ 

E5 


PUSH 

H 

SAVE POINTER 

002P ’ 

AF 


XRA 

A 

♦ 

0030’ 

CD 0000:05 


CALL 

XTNTRY# 

SEND TO COM CHANNEL 

0033’ 

El 


POP 

H 

RESTORE POINTER 

0034’ 

D1 


POP 

D 

RESTORE CH NO. 

0035’ 

23 


I NX 

H 

INCREASE POINTER 

0036’ 

18EE 


JMPR 

CLOOP 

END DO 

f038 ’ 

El 

SRET: 

POP 

H 

RESTORE REGISTERS 

L039’ 

D1 


POP 

D 


003A’ 

Cl 


POP 

B 

• 

003B ’ 

FI 


POP 

PSW 

♦ 

003C ’ 

C9 


RET 


RETURN 


!end 
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INSTALLING BACKGROUND BATCH 

O verview 

The Turbo-Plus Background Batch System operates on its own 
dedicated slave board. It requires a number of .COM files and 
related data files. It allows job scheduling, maintains a log of 
batch operation, and offers utilities to list current and pending 
jobs and to delete jobs. 

The batch system requires two user areas: one on the system 
boot disk, and another on user zero of any drive on the system. 
Furthermore, it requires the presence of supporting .COM files in 
user 0 of the system search drive. All of the modules can be 
easily installed in any user area using the background batch 

uieuaiiauiuii j;rugraui, iAo iajj • 


Patching 


The program modules which require patching are BB, BBACK, 
BBCANCEL, BBDEL, BBEGIN, BBLIST, and BBLOG. The patches are 
needed to tell the batch system on which user area its files will 
be kept. To do this customization, run the BBINSTAL program 
included on the distribution diskette. This program will issue a 
series of questions about the manner in which you want to set up 
your background batch. It will then proceed to generate the 
necessary parameter files, and start a DO process to generate the 
.COM files, and move all of the modules to the necessary user 
' reas on the system. A sample background batch installation 
session follows. All user input is underlined. 


SF1 BBINSTAL 


BB requires one user area on the system boot disk where a 
WARMSTRT.AUT file will be placed. Nobody else should log 
on to this area of the boot disk. Which area would you 
like this to be? (1-30): 1 


BB requires one user area anywhere else on the system 
where it maintains all of its files. This should be 
preferably on the hard disk, if you have one. It will 
use user 0 on the drive you select. 

What drive would you like it to use? (A-P): H 

What is your system search drive? (A-P): H 


The Background Batch processor will require one slave 
board dedicated to it. Which slave will you set up 
to service the background batch? (A-P): B 
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Copyright (C) 1982, Software 2000, Inc. 
BB 

TPMOD 
Pass 1 

BB TPEQU TPMOD 

Pass 2 

BB TPEQU TPMOD 

Processing parameter file: 

DRIVE = 07 

Writing output file 


SP1COPY 

* BBEGIN.COM 01A:WARMSTRT.AUT;N 


5F:BBEGIN 
* BB.COM OH: 

.COM 

;N 

copied 

to 

1A:WARMSTRT 

.AUT 

53?: BB 

* BBLIST.COM 

.COM 
[ OH: ;N 

copied 

to 

OH: BB 

.COM 

5F:BBLIST 
* BBACK.COM 

. COM 
OH: ;N 

copied 

to 

OH .-BBLIST 

.COM 

5F:BBACK 
* BBLOG COM 

.COM 
OH: ;N 

copied 

to 

OH:BBACK 

.COM 

5F:BBLOG 
* BBCUR.JOB 

.COM 
OH: ;N 

copied 

to 

OH .-BBLOG 

.COM 

5F:BBCUR 
* BEJOBS OH: 

.JOB 

;N 

copied 

to 

OH:BBCUR 

.JOB 

5F:BBJOBS 
* BBLOG QIB: 


copied 

to 

OH:BBJOBS 


5F:BBLOG 

* 

oF 


copied 

to 

OH:BBLOG 
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Slave Generation 

C Finally, a number of modifications to your system generation 
.ust be completed: 

Two changes must be made in the system .SYS files: First, a 
new slave must be generated for the batch system. This slave 
should have one change made in its .GEN file: Replace its console 
driver (typically C0N96) with CONBB.REL, also supplied on user 0 
of the installation disk. The slave’s .PAR file should be 
changed with the LOGTTSR parameter included, setting up the slave 
to log automatically onto the user area containing WARMSTRT.AUT. 
(E.g. If you choose to warmstart into user 1 of the boot drive, 
the patch should be LOGUSR - 1.) It is also advisable to have 
this slave printing to some remote queue or to file. rather than 
directly to a printer or to console, since in the latter two 
cases it would be easy to lose desired output produced by any 
jobs running in the batch processor. This is accomplished via 
the PRTMOD and QUEPTR parameters documented in the TurboDOS 
Configuration Guide. This slave must then be generated into the 
system master file, by changing the slave table, NMBSLV 
parameter, and NMBXXX parameter (where XXX is the particular 
slave.) The new slave and master must be generated in the normal 
system generation manner, and the Turbo-Plus batch system will be 
ready for operation upon system reset. 
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Appendix A 

Modifying a Slave Circuit Driver for Turbo-Plus 


If you are using slave boards with incorrect circuit 
drivers, it is highly recommended that you patch the slave 
circuit driver source code (SCD???.ASM) in order to use TWX and 
RESET commands. 

The change to be made occurs at the end of the interrupt 
service routine in the circuit driver. If the last two lines of 
your routine are: 

El ; Enable Interrupts 
RETI ; Return 

replace them with: 


JMP ISRXIT# ; Jump to ISR exit 

If the last two lines of that routine are different, contact your 
dealer. 
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Appendix B 

Installing Turbo-Plus on a Multi-circuit System 


It is possible that your system has two types of slave 
boards installed, in which case you will need to add one extra 
patch to the master . PAB file. This patch is for the Turbo-Plus 
slave table, and has the label TPSTBL, with the foilwing default 
value: 


TPSTBL = (0001),(0002),(0003),(0004),(0005),(0006),(0007),(0008) 
(0009),(000A),(000B),(000C),(000D),(000E),(000F),(0010) 


The sixteen words in this table contain the network 
addresses of the slaves which Turbo-Pius will refer to as A 
through P respectively. Thus, under the default configuration, a 
single circuit with up to sixteen slaves will define those slaves 
as A-P in the order that they are referred to in your circuit 
driver’s port assignment table. 

For a specific example, let us consider a system having 
three slave circuits, with five slaves on the first, two on the 
second, and four on the third. In this case, we are only worried 
about the first eleven entries in the table. We must change the 
network addresses of slaves F-K, as follows: 

TPSTBL = (0001),(0002),(0003),(0004),(0005),(0101), 

(0102),(0201),(0202),(0203),(0204) 
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Following is a proposal for a parameter passing protocol for 
the TurboDOS user function. This convention will allow for the 
coexistence of numerous user function packages in a TurboDOS 
system. At this time it is generally not possible to use more 
than one user function in a given system configuration. The 
design of this protocol takes into account all actively used 
versions of TurboDOS, including VI.40, in which the methods for 
routing user function requests have been altered. 


BACKGROUND 
Current Problems 

There are currently two primary problems in using multiple user 
motion packages produced by independent authors: 

1) TurboDOS provides only one user function entry point 
(USRFCN), so methods for including multiple functions 
must be mutually agreed upon by all concerned user 
function authors. 

2) All authors of user functions must choose their own 
exclusive range of sub-function numbers in order to avoid 
conflict. To date, this has not been an issue since 
only one user function may be included in a system 
generation. 

Current Conventions 

There are two commonly used user function parameter passing 
protocols: The first uses the E register as the sub-function 

number and the HL register pair for other arguments. The second 
passes sub-functions in the L register and uses the DE pair for 
word length arguments. 

However, TurboDOS version 1.4 uses the DE pair to specify network 
routing. Therefore, to create user functions compatible with al1 
versions of TurboDOS, only the HL pair may be used for passing 
parameters to user functions. Any additional parameters must be 
passed through the DMA transfer area. 
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DESIGN PEOPOSAL 
Design Goal 

The goal of this design is to create a standard application- 
independent interface for the TurboDOS user function that will 
allow multiple user function packages to be included in a system 
configuration without requiring that the respective authors 
coordinate their entry point naming and sub-function number 
usage. 

User Function Initialization 

A general purpose INIT time ^ntry point for a user function 
initialization routine is required. While a number of OEM’s have 
incorporated such an entry point into their own hardware 
initialization routines, our goal is to keep this convention 
hardware and software independent. 

We propose, therefore, to create a user function initialization 
entry point via the method currently used by the Turbo-Plus 
software package. This procedure involves patching a jump from 
the LCLUSB initialization routine to the user function 
initialization entry point. The patch LCLNIT + 7 = USBNIT under 
versions 1.82 and 1.30, and LCLNIT + OD = USBNIT under version 
1.40 forces the LCLUSR initialization routine to jump to our 
initialization routine, instead of CLBNIT, as its last jump. 
Thus, we may use this convention to support an initialization 
routine with the entry point USBNIT::. After user function 
initialization, a jump will be made to CLBNIT#. 

Note: Under TurboDOS VI.41, the USRSUP module and a kernel level 
initialization-time call to USBNIT are being supplied with 
TurboDOS by Software 2000. Therefore, the preceding paragraph 
can be ignored for users of VI.41 or later. 

The USBNIT initialization routine will support an arbitrary 
number of user function packages (8 seems reasonable). USBNIT 
will call USRINA#, USBINB#, USBINC#, etc. If the called USRIN% 
routine is present, our convention specifies that the routine 
return the number of subfunctions required in the A register, and 
an eight byte package name at the address pointed to by the value 
returned in the HL register pair. Thus, a return code of 0 in 
the A register will mean that either the user-defined function 
did not exist (in which case the TurboDOS .UND.:: routine will 
return a 0) or it was merely a piece of initialization code which 
did not support any subfunctions. The main initialization 
routine will store each returned package name and computed 
function base in an internal table. 

User Function Package Entry Points 

User function packages conforming to our protocol will use the 
entry point USRFC96: : . One common module, also supplied by the 
authors of this proposal, will be responsible for dispatching 
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each included user function package when a call to USRFCN is 
.made. 

ailing Sequence for Application Programs 

Our protocol requires that one change be made to each application 
program that will call user functions. At the beginning of each 
program that will call a user function, a call must be made to 
the user function sub-function 0. The user function package name 
that the program is to access is passed at the DMA address. The 
user function 0 call returns with 0 in the A register, indicating 
that the package is not available, or with a user function sub¬ 
function offset. The calling program may, from then on, access 
the requested user function package by calling USRFCN and adding 
the returned offset to the package’s sub-function number. 

When the main USRFCN dispatch routine is called, it will know 
from the range of the sub-function which user-function package is 
desired. It will then subtract the appropriate offset from the 
sub-function and jump to the correct package. In this fashion, 
all user function packages may be coded with sub-function numbers 
beginning with 0. 

If a program must route user functions to multiple destinations, 
then an initialization call in the program is necessary for each 
of those destinations. This procedure is necessary in case the 
user function is genned in different locations in the various 
destinations. The sub-function offsets must be saved and re-used 
r henever calls are made to the corresponding user function 
packages. Although these initialization calls add a small one 
time overhead, the added flexibility is well worth the computing 
time cost. 

COMMENTS 

Although this protocol is significantly more complicated than the 

de facto standard of pre-allocating sub-function numbers between 
authors, a flexible convention must be designated. Therefore it 
is worth any recoding necessary to guarantee the possibility of 
user function coexistence in the future. 



